This pull request was created as a result of the following prompt from Copilot chat.

Summary:
The docs/ folder is used to deploy the project site via GitHub Pages. After a script regenerated docs/*.md files, mermaid diagrams stopped rendering and some pages appear unprocessed. Root causes likely include missing YAML front matter in regenerated Markdown files, missing/incorrect docs/_layouts/default.html that loads assets, asset path mismatches due to missing site.baseurl usage, and lack of a mermaid initialization script that converts fenced mermaid code blocks to .mermaid divs and calls mermaid.init().

Goal:
Create a PR that restores proper GitHub Pages rendering for docs/ mermaid diagrams and ensures the static site builds correctly when docs/*.md are re-generated by scripts. The PR should add or update files in the docs/ tree and update content while preserving existing page content.

Deliverables (actions for the coding agent):

1. Ensure docs/pipeline_map.md and docs/project_audit.md (and any other docs/*.md that include mermaid fences) have YAML front matter. If a file is missing front matter, prepend a minimal front matter block that preserves existing content. Use this template:

---

layout: default
title: "REPLACE_WITH_PAGE_TITLE"

(Replace the title with a one-line title derived from the file name; keep the rest of the file unchanged.)

2. Add docs/_layouts/default.html if it does not exist, or update it if present, to ensure site skeleton includes scripts/styles with site.baseurl/relative_url. The layout must include at minimum:

• meta charset and viewport
• link to css at {{ '/assets/css/style.css' | relative_url }} (if present)
• mermaid JS inclusion via CDN (defer) and a local mermaid-init.js using relative_url, loaded with defer
• yield the page content with {{ content }}

Provide a safe, minimal layout that will not overwrite custom head blocks if they already exist (i.e., keep markup simple but workable).

3. Add docs/assets/js/mermaid-init.js that:

• waits for DOMContentLoaded
• finds

   or code.language-mermaid blocks

• converts them into
  with the inner text preserved
• calls mermaid.initialize({ startOnLoad: false }) and then mermaid.init(undefined, document.querySelectorAll('.mermaid'))
• uses defensive checks so it fails silently if mermaid is not loaded

Use the following implementation (agent should create file with this content):
(function(){
function migrateMermaidCodeBlocks(){
try{
var codes = document.querySelectorAll('pre > code.language-mermaid, pre > code.lang-mermaid');
codes.forEach(function(code){
var pre = code.parentNode;
var container = document.createElement('div');
container.className = 'mermaid';
container.textContent = code.textContent;
pre.parentNode.replaceChild(container, pre);
});
if(window.mermaid && typeof window.mermaid.init === 'function'){
window.mermaid.initialize({ startOnLoad: false });
window.mermaid.init(undefined, document.querySelectorAll('.mermaid'));
}
}catch(e){
console.warn('mermaid-init error', e);
}
}
if(document.readyState === 'loading') document.addEventListener('DOMContentLoaded', migrateMermaidCodeBlocks);
else migrateMermaidCodeBlocks();
})();

4. Ensure docs/_config.yml contains correct url and baseurl for project site. If baseurl is missing or incorrect, update (or add) these keys:
   url: "https://basic-nature.github.io"
   baseurl: "/html_Parser_prototype"

If docs/_config.yml already contains these keys, do not overwrite other configs; only set/add these two keys if missing or wrong.

5. Update any layouts or include files to reference scripts/styles using relative_url or prepend {{ site.baseurl }} to absolute assets. Specifically, change script/link tags to use the Liquid filters like: {{ '/assets/js/mermaid-init.js' | relative_url }}. Do not hardcode absolute paths beginning with '/'.

6. Add a short README note docs/README_pages_FIX.md describing what changed and why (front matter, baseurl, mermaid-init), so future generators preserve front matter and assets.

7. Tests and verification steps (in PR description):

• Run a local Jekyll build (bundle exec jekyll build --source docs --destination _site) and confirm that pipeline_map.html and project_audit.html are generated under _site and contain
  elements rather than raw fenced blocks.
• Open the generated HTML in a browser (or inspect generated HTML) to ensure the mermaid-init script is referenced and asset URLs include the baseurl path.
• In browser DevTools (Network tab) ensure there are no 404s for mermaid-init.js or mermaid.min.js and check Console for no mermaid-related errors.

Implementation notes and constraints for the agent:

• Preserve existing content inside docs/*.md files (only add front matter when missing, do not modify other text except the insertion).
• When updating docs/_config.yml, preserve other keys and comments. Add or update only url and baseurl.
• When adding files, use the docs/ path and adjust any directory creation needed (docs/_layouts, docs/assets/js).
• Add minimal tests or verification steps to the PR description explaining how to verify manually.
• Use a concise, descriptive PR title like: "fix(docs): restore mermaid rendering and site baseurl handling for GitHub Pages"

Please open a pull request in repository Basic-Nature/html_Parser_prototype with the changes above. Leave base_ref blank (use default branch). Do not assign reviewers. Include the verification steps in the PR body.